3-6 肭禰誘u@韃僂う MEX 仵袙d

本節的 MEX 檔案是 putarray.c，可將輸入矩陣乘以 2 之後，存放成 MATLAB 基本工作空間中的一個變數，其程式碼如下；

原始檔（03-應用程式介面/putarray.c）：

（灰色區域按兩下即可拷貝）

/*=================================================================
 * putarray.c 
 *
 * This example demonstrates how to use mexPurVariable and mexFunctionName.
 * This function takes an input argument, multiplies it by two, and put
 * it into MATLAB base workspace under a variable name "putarray_output".
 *
 * Roger Jang, 19991003, 20070223
/*=================================================================*/
 
#include <stdio.h>
#include <string.h>
#include <math.h>
#include "mex.h"	/* mex.h 包含 mxArray 結構的定義，以及其他相關資訊 */

/* prhs = pointer to the right-hand-side arguments，即指向輸入變數列的指標 */
#define IN prhs[0]	/* 定義 IN 為此函式的第一個輸入變數，以便後續取用 */

/* 此函式為和 MATLAB 溝通的主要函式 */
void
mexFunction(int nlhs,mxArray *plhs[],int nrhs,const mxArray *prhs[]) { 
	char arrayName[40];
	mxArray *arrayPtr;
	int i, status;
    
	/* 檢查輸出變數個數是否為0、輸入變數個數是否為1，其中      */
	/* nrhs = no. of right-hand-side arguments（輸入變數個數） */
	/* nlhs = no. of  left-hand-side arguments（輸出變數個數） */
	if (nrhs!=1) { mexErrMsgTxt("One input arguments required."); } 
	if (nlhs>1) { mexErrMsgTxt("Too many output arguments."); }

	/* 檢查輸入變數資料型態是否符合要求 */
	if (!mxIsDouble(IN) || mxIsComplex(IN))
		mexErrMsgTxt("Input must be real double.");
    
	/* 產生MATLAB基本工作空間的變數名稱，等於此MEX主檔名加上「_output」 */
	strcpy(arrayName, mexFunctionName());
	strcat(arrayName,"_output");

	/* 產生一個資料型態為double的陣列 */
	arrayPtr = mxCreateDoubleMatrix(mxGetM(IN), mxGetN(IN), mxREAL);

	/* 將此陣列的實部乘以2 */
	for (i=0; i<mxGetM(IN)*mxGetN(IN); i++)
		mxGetPr(arrayPtr)[i] = 2*(mxGetPr(IN)[i]);

	/* 將此陣列送到MATLAB的基本工作空間 */
	status = mexPutVariable("base", arrayName, arrayPtr);
    
	if (status==1){	/* 無法將此陣列送到MATLAB的基本工作空間，印出失敗訊息 */
		mexPrintf("Variable %s\n", arrayName);
		mexErrMsgTxt("Could not put variable in the base workspace.\n");
	}
	/* 成功地將此陣列送到MATLAB的基本工作空間，印出成功訊息 */
	mexPrintf("\"%s\" is created in the base workspace.\n", arrayName);
    
	/* 刪除先前產生的陣列，將佔用的記憶體歸還給作業系統*/
	mxDestroyArray(arrayPtr);
}

可編譯及測試如下：

>> clear all >> mex putarray.c >> putarray([1 2 5]) "putarray_output" is created in the base workspace. >> whos Name Size Bytes Class Attributes putarray_output 1x3 24 double 其中 putarray_output 即是由 putarray 所置放在 MATLAB 基本工作空間的變數，可以檢視如下： >> putarray_output putarray_output = 2 4 10

這個 MEX 檔案範例相當重要，可能的應用很多，例如：

• 從 RS232 埠讀取 GPS 傳回的資料，將資料進行初步的處理後送入 MATLAB 的基本工作空間，MATLAB 再根據此工作空間的變數進行即時的圖形繪製或成像。
• 從影像擷取卡或外部裝置抓取影像資像，並送入 MATLAB 的基本工作空間，MATLAB 再根據此資料進行即時的計算，例如人臉辨識或指紋辨識等。

---

MATLAB程式設計：進階篇